home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / lisp / clisp-li.000 / clisp-li / clisp-1996-07-22 / doc / clisp.man < prev    next >
Encoding:
Text File  |  1996-07-22  |  8.3 KB  |  265 lines
  1.  
  2.  
  3.  
  4. CLISP(1)                                                 CLISP(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        clisp - Common Lisp language interpreter and compiler
  9.  
  10. SSYYNNOOPPSSIISS
  11.        cclliisspp [ --hh ] [ --mm _m_e_m_s_i_z_e ] [ --MM _m_e_m_f_i_l_e ] [ --LL _l_a_n_g_u_a_g_e ]
  12.        [ --qq ] [ --II ] [ --ii _i_n_i_t_f_i_l_e ...  ] [ --cc [ --ll ] _l_i_s_p_f_i_l_e  [
  13.        --oo  _o_u_t_p_u_t_f_i_l_e ] ...  ] [ --pp _p_a_c_k_a_g_e_n_a_m_e ] [ --xx _e_x_p_r_e_s_s_i_o_n
  14.        ]
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.        Invokes the common lisp interpreter and compiler.  Invoked
  18.        without  arguments,  executes  a  read-eval-print loop, in
  19.        which expressions are in turn read  from  standard  input,
  20.        evaluated  by the lisp interpreter, and their results out-
  21.        put to standard output.  Invoked with  --cc,  the  specified
  22.        lisp files are compiled to a bytecode that can be executed
  23.        more efficiently.
  24.  
  25. OOPPTTIIOONNSS
  26.        --hh     Displays a help message on how to use cclliisspp.
  27.  
  28.        --mm _m_e_m_s_i_z_e
  29.               Sets the amount of memory cclliisspp tries  to  grab  on
  30.               startup.   The amount may be given as _n_n_n_n_n_n_n (mea-
  31.               sured in bytes), _n_n_n_nKK or _n_n_n_nKKBB (measured in kilo-
  32.               bytes)  or  _nMM  or  _nMMBB  (measured  in  megabytes).
  33.               Default is  2  megabytes.   The  argument  is  con-
  34.               strained between 100 KB and 16 MB.  -- This version
  35.               of cclliisspp allocates memory dynamically.  _m_e_m_s_i_z_e  is
  36.               essentially ignored.
  37.  
  38.        --MM _m_e_m_f_i_l_e
  39.               Specifies the initial memory image.  This must be a
  40.               memory dump produced by the  _s_a_v_e_i_n_i_t_m_e_m  function.
  41.               It  may  have been compressed using GNU gzip.  This
  42.               option is normally already set by the shell  script
  43.               //uussrr//llooccaall//bbiinn//cclliisspp.
  44.  
  45.        --LL _l_a_n_g_u_a_g_e
  46.               Specifies  the  language  cclliisspp uses to communicate
  47.               with the user. This may be eenngglliisshh, ddeeuuttsscchh,  ffrraann--
  48.               ccaaiiss.
  49.  
  50.        --qq     Quiet:  cclliisspp  displays no banner at startup and no
  51.               good-bye message when quitting.
  52.  
  53.        --II     ILISP friendly: cclliisspp interacts in a way that ILISP
  54.               (a  popular  Emacs  LISP  interface) can deal with.
  55.               Currently the only effect of this is that  unneces-
  56.               sary  prompts are not suppressed.  Furthermore, the
  57.               GNU readline library treats Tab as a  normal  self-
  58.               inserting character.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                            15 June 1995                         1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CLISP(1)                                                 CLISP(1)
  71.  
  72.  
  73.        --ii _i_n_i_t_f_i_l_e _._._.
  74.               Specifies  initialization  files  to  be  _l_o_a_ded at
  75.               startup. These should be lisp files (source or com-
  76.               piled).
  77.  
  78.        --cc _l_i_s_p_f_i_l_e _._._.
  79.               Compiles  the  specified _l_i_s_p_f_i_l_es to bytecode. The
  80.               compiled files can then be _l_o_a_ded  instead  of  the
  81.               sources to gain efficiency.
  82.  
  83.        --oo _o_u_t_p_u_t_f_i_l_e
  84.               Specifies the output file or directory for the com-
  85.               pilation of the last specified _l_i_s_p_f_i_l_e.
  86.  
  87.        --ll     A bytecode listing of the files being compiled will
  88.               be produced.  Useful only for debugging purposes.
  89.  
  90.        --pp _p_a_c_k_a_g_e_n_a_m_e
  91.               At startup the value of the variable _*_p_a_c_k_a_g_e_* will
  92.               be set to the package named _p_a_c_k_a_g_e_n_a_m_e.
  93.  
  94.        --xx _e_x_p_r_e_s_s_i_o_n_s
  95.               Executes a series of arbitrary expressions  instead
  96.               of  a  read-eval-print  loop.   The  values  of the
  97.               expressions will be output to standard output.  Due
  98.               to  the  argument processing done by the shell, the
  99.               _e_x_p_r_e_s_s_i_o_n_s must be enclosed in single quotes,  and
  100.               double  quotes  and backslashes must be preceded by
  101.               backslashes.
  102.  
  103.  
  104. RREEFFEERREENNCCEE
  105.        The language implemented conforms to
  106.               Guy L. Steele Jr.: Common Lisp - The Language.
  107.               Digital Press. 1st edition 1984, 465 pages.
  108.               ("CLtL1" for short)
  109.        and to the older parts of
  110.               Guy L. Steele Jr.: Common Lisp - The Language.
  111.               Digital Press. 2nd edition 1990, 1032 pages.
  112.               ("CLtL2" for short)
  113.  
  114. UUSSEE
  115.        hheellpp   to get some on-line help.
  116.  
  117.        ((aapprrooppooss _n_a_m_e))
  118.               lists the symbols relating to _n_a_m_e.
  119.  
  120.        ((eexxiitt)) or ((qquuiitt)) or ((bbyyee))
  121.               to quit cclliisspp.
  122.  
  123.        EOF (Ctrl-D)
  124.               to leave the current read-eval-print loop.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                            15 June 1995                         2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CLISP(1)                                                 CLISP(1)
  137.  
  138.  
  139.        arrow keys
  140.               for editing and viewing the input history.
  141.  
  142.        Tab key
  143.               to complete the symbol's name you are just  typing.
  144.  
  145. FFIILLEESS
  146.        _c_l_i_s_p  startup script
  147.  
  148.        _l_i_s_p_._r_u_n
  149.               main executable
  150.  
  151.        _l_i_s_p_i_n_i_t_._m_e_m
  152.               initial memory image
  153.  
  154.        _c_o_n_f_i_g_._l_s_p
  155.               site-dependent configuration
  156.  
  157.        _*_._l_s_p  lisp source
  158.  
  159.        _*_._f_a_s  lisp code, compiled by cclliisspp
  160.  
  161.        _*_._l_i_b  lisp source library information, generated and used
  162.               by the cclliisspp compiler
  163.  
  164.        _*_._c    C code, compiled from lisp source by cclliisspp
  165.  
  166. EENNVVIIRROONNMMEENNTT
  167.        CCLLIISSPP__LLAANNGGUUAAGGEE
  168.               specifies the language cclliisspp  uses  to  communicate
  169.               with  the  user. The value may be eenngglliisshh, ddeeuuttsscchh,
  170.               ffrraannccaaiiss and defaults to eenngglliisshh.   The  --LL  option
  171.               can  be used to override this environment variable.
  172.  
  173.        LLAANNGG   specifies the language cclliisspp  uses  to  communicate
  174.               with  the  user,  unless  it  is  already specified
  175.               through the environment variable CCLLIISSPP__LLAANNGGUUAAGGEE  or
  176.               the  --LL  option.  The  value  may begin with a two-
  177.               letter ISO 639 language code, for example  eenn,  ddee,
  178.               ffrr.
  179.  
  180.        HHOOMMEE and UUSSEERR
  181.               are  used for determining the value of the function
  182.               _u_s_e_r_-_h_o_m_e_d_i_r_-_p_a_t_h_n_a_m_e.  (Unix implementation only.)
  183.  
  184.        SSHHEELLLL (Unix implementation only)
  185.               is used to find the interactive command interpreter
  186.               called by _(_s_h_e_l_l_).
  187.  
  188.        TTEERRMM   determines the screen size recognized by the pretty
  189.               printer.   This environment variable is also manda-
  190.               tory for the built-in screen editor.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                            15 June 1995                         3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. CLISP(1)                                                 CLISP(1)
  203.  
  204.  
  205. SSEEEE AALLSSOO
  206.        _c_m_u_l_i_s_p(1), _e_m_a_c_s(1).
  207.  
  208. BBUUGGSS
  209.        The function _i_n_s_p_e_c_t is not implemented.
  210.  
  211.        Not all extensions from CLtL2 are supported.
  212.  
  213.        No on-line documentation beyond _a_p_r_o_p_o_s  and  _d_e_s_c_r_i_b_e  is
  214.        available.
  215.  
  216. PPRROOJJEECCTTSS
  217.        Writing on-line documentation.
  218.  
  219.        Write _i_n_s_p_e_c_t.
  220.  
  221.        Enhance  the  compiler such that it can inline local func-
  222.        tions.
  223.  
  224.        Specify a portable set of window and graphics  operations.
  225.  
  226. AAUUTTHHOORRSS
  227.        Bruno   Haible  <haible@ma2s2.mathematik.uni-karlsruhe.de>
  228.        and Michael Stoll.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                            15 June 1995                         4
  263.  
  264.  
  265.